Package | flash.globalization |
Classe | public final class DateTimeFormatter |
Héritage | DateTimeFormatter Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Il existe deux manières de sélectionner un format de date et d’heure : au moyen d’un modèle prédéfini ou d’un modèle personnalisé. Pour la plupart des applications, les styles prédéfinis spécifiés par la constante DateTimeStyle (LONG
, MEDIUM
, NONE
ou SHORT
doivent être utilisés. Ces constantes spécifient les modèles par défaut en fonction des paramètres régionaux requis ou les modèles par défaut basés sur les paramètres du système d’exploitation de l’utilisateur.
Par exemple, le code suivant crée une chaîne de date à l’aide du format de date court par défaut :
var df:DateTimeFormatter = new DateTimeFormatter(LocaleID.DEFAULT, DateTimeStyle.SHORT, DateTimeStyle.NONE); var currentDate:Date = new Date(); var shortDate:String = df.format(currentDate);
Lorsqu’une occurrence de cette classe est créée, si les paramètres régionaux sont pris en charge par le système d’exploitation, les propriétés de l’occurrence sont définies en fonction des conventions et des valeurs par défaut des paramètres régionaux requis, ainsi que des paramètres dateStyle
et timeStyle
du constructeur. Si les paramètres régionaux requis ne sont pas disponibles, les propriétés sont définies en fonction de paramètres régionaux par défaut, pouvant être obtenus à l’aide de la propriété actualLocaleIDName
.
Cette classe contient d’autres méthodes pour obtenir les chaînes localisées correspondant au nom des mois et des jours de la semaine, ainsi que le premier jour de la semaine pouvant être utilisé dans un sélecteur de calendrier ou d’autres applications similaires.
En raison de l’utilisation des paramètres définis par l’utilisateur, des modèles de formatage fournis par le système d’exploitation et des paramètres régionaux par défaut (lorsque les paramètres régionaux requis ne sont pas pris en charge), différents utilisateurs peuvent obtenir différents résultats de formatage, même s’ils ont recours au même ID de paramètres régionaux.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
actualLocaleIDName : String [lecture seule]
Nom de l’ID de paramètres régionaux actuel utilisé par cet objet DateTimeFormatter. | DateTimeFormatter | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
lastOperationStatus : String [lecture seule]
Etat de dernière opération que cet objet DateTimeFormatter a effectuée. | DateTimeFormatter | ||
requestedLocaleIDName : String [lecture seule]
Nom de l’ID de paramètres régionaux requis ayant été transmis au constructeur de cet objet DateTimeFormatter. | DateTimeFormatter |
Méthode | Défini par | ||
---|---|---|---|
DateTimeFormatter(requestedLocaleIDName:String, dateStyle:String = "long", timeStyle:String = "long")
Construit un nouvel objet DateTimeFormatter en vue de formater les dates et les heures conformément aux conventions des paramètres régionaux spécifiés, ainsi qu’aux styles de formatage de la date et de l’heure fournis. | DateTimeFormatter | ||
Formate une chaîne d’affichage pour un objet Date interprété comme étant en heure locale de l’utilisateur (utilisation des composants d’heure locale de l’objet Date, tels que date, day, fullYear, hours, minutes, month et seconds). | DateTimeFormatter | ||
Formate une chaîne d’affichage pour un objet Date interprété comme étant en heure UTC (utilisation des composants UTC de l’objet Date, tels que dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC et secondsUTC), conformément au modèle dateStyle, timeStyle ou dateTime. | DateTimeFormatter | ||
[statique]
Répertorie tous les noms des ID de paramètres régionaux pris en charge par cette classe. | DateTimeFormatter | ||
Obtient le style de date de cette occurrence de DateTimeFormatter. | DateTimeFormatter | ||
Renvoie la chaîne modèle utilisée par cet objet DateTimeFormatter pour formater la date et l’heure. | DateTimeFormatter | ||
Renvoie un nombre entier correspondant au premier jour de la semaine les paramètres régionaux et le système calendaire spécifiés. | DateTimeFormatter | ||
Extrait une liste de chaînes localisées contenant le nom des mois du système calendaire actuel. | DateTimeFormatter | ||
Obtient le style d’heure de cette occurrence de DateTimeFormatter. | DateTimeFormatter | ||
Extrait une liste de chaînes localisées contenant le nom des jours de la semaine du système calendaire actuel. | DateTimeFormatter | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Définit la chaîne modèle utilisée par cet objet DateTimeFormatter pour formater la date et l’heure. | DateTimeFormatter | ||
Définit les styles de date et d’heure pour cette occurrence de DateTimeFormatter. | DateTimeFormatter | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
actualLocaleIDName | propriété |
actualLocaleIDName:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Nom de l’ID de paramètres régionaux actuel utilisé par cet objet DateTimeFormatter.
Il existe trois possibilités pour la valeur du nom, en fonction du système d’exploitation et de la valeur du paramètre requestedLocaleIDName
transmis au constructeur Collator()
.
- Si les paramètre régionaux requis n’étaient pas définis sur
LocaleID.DEFAULT
et que le système d’exploitation les prend en charge, le nom renvoyé est identique à la propriétérequestedLocaleIDName
. - Si
LocaleID.DEFAULT
a été utilisée comme valeur pour le paramètrerequestedLocaleIDName
transmis au constructeur, le nom des paramètres régionaux spécifié par le système d’exploitation de l’utilisateur est utilisé. La valeurLocaleID.DEFAULT
préserve le paramètre personnalisé de l’utilisateur dans le système d’exploitation. La transmission d’une valeur explicite en tant que paramètrerequestedLocaleIDName
ne produit pas nécessairement le même résultat que l’utilisation deLocaleID.DEFAULT
, même si le nom des deux identificateurs de paramètres régionaux est identique. Il est possible que l’utilisateur ait personnalisé les paramètres régionaux sur son ordinateur ; or, si vous demandez un identificateur de paramètres régionaux explicite au lieu d’utiliserLocaleID.DEFAULT
, votre application ne récupérera pas ces paramètres personnalisés. - Si le système ne prend pas en charge le paramètre
requestedLocaleIDName
spécifié dans le constructeur, un nom d’ID de paramètres régionaux par défaut est fourni.
Implémentation
public function get actualLocaleIDName():String
Eléments de l’API associés
lastOperationStatus | propriété |
lastOperationStatus:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Etat de dernière opération que cet objet DateTimeFormatter a effectuée. La propriété lastOperationStatus
est définie chaque fois que le constructeur ou une méthode de cette classe est appelé(e), ou qu’une autre propriété est définie. Pour les valeurs disponibles, voir la description de chaque méthode.
Implémentation
public function get lastOperationStatus():String
Eléments de l’API associés
requestedLocaleIDName | propriété |
requestedLocaleIDName:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Nom de l’ID de paramètres régionaux requis ayant été transmis au constructeur de cet objet DateTimeFormatter.
Si la valeur LocaleID.DEFAULT
a été utilisée, le nom renvoyé est "i-default". Les paramètres régionaux actuels peuvent différer des paramètres régionaux requis lorsque des paramètres régionaux par défaut sont appliqués. Il est possible de récupérer le nom du paramètre régional actuel à l’aide de la propriété actualLocaleIDName
.
Implémentation
public function get requestedLocaleIDName():String
Eléments de l’API associés
DateTimeFormatter | () | Constructeur |
public function DateTimeFormatter(requestedLocaleIDName:String, dateStyle:String = "long", timeStyle:String = "long")
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Construit un nouvel objet DateTimeFormatter en vue de formater les dates et les heures conformément aux conventions des paramètres régionaux spécifiés, ainsi qu’aux styles de formatage de la date et de l’heure fournis. Les styles de date et d’heure sont utilisés pour définir les modèles de formatage de date et d’heure sur les modèles prédéfinis en fonction des paramètres régionaux à partir du système d’exploitation.
Ce constructeur détermine si le système d’exploitation actuel prend en charge le nom de l’identificateur de paramètres régionaux requis. Si ce n’est pas le cas, des paramètres régionaux de substitution sont utilisés. Il est possible de déterminer le nom de l’ID des paramètres régionaux de substitution via la propriété actualLocaleIDName
.
Si une valeur de substitution est utilisée pour l’un des paramètres requestedLocaleIDName
, dateStyle
ou timeStyle
, la propriété lastOperationStatus
est définie pour indiquer le type de valeur de substitution.
Pour effectuer un formatage en fonction des préférences de l’utilisateur du système d’exploitation actuel, transmettez la valeur LocaleID.DEFAULT
du paramètre requestedLocaleIDName
au constructeur.
Lorsque le constructeur est appelé et que l’appel aboutit, la propriété lastOperationStatus
est définie sur :
LastOperationStatus.NO_ERROR
Lorsque le nom de l’identificateur de paramètres régionaux requis n’est pas disponible, la propriété lastOperationStatus
est définie sur l’une des valeurs suivantes :
LastOperationStatus.USING_FALLBACK_WARNING
LastOperationStatus.USING_DEFAULT_WARNING
Sinon, la propriété lastOperationStatus
est définie sur l’une des constantes définies dans la classe LastOperationStatus.
Pour plus d’informations sur les avertissements répertoriés ci-dessus et d’autres valeurs possibles de la propriété lastOperationStatus
, voir les descriptions de la classe LastOperationStatus
.
requestedLocaleIDName:String — Nom de l’identificateur de paramètres régionaux à utiliser lors de la spécification des formats de date ou d’heure.
| |
dateStyle:String (default = "long ") — Spécifie le style à utiliser lors du formatage des dates. La valeur correspond à l’une des valeurs énumérées par la classe DateTimeStyle :
| |
timeStyle:String (default = "long ") — Spécifie le style à utiliser lors du formatage des heures. La valeur correspond à l’une des valeurs énumérées par la classe DateTimeStyle :
|
Valeur émise
ArgumentError — si le paramètre dateStyle ou timeStyle n’est pas une constante DateTimeStyle valide.
| |
TypeError — si le paramètre dateStyle ou timeStyle est défini sur null.
|
Eléments de l’API associés
format | () | méthode |
public function format(dateTime:Date):String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Formate une chaîne d’affichage pour un objet Date interprété comme étant en heure locale de l’utilisateur (utilisation des composants d’heure locale de l’objet Date, tels que date, day, fullYear, hours, minutes, month et seconds). Le formatage est effectué à l’aide des conventions de l’ID de paramètres régionaux et des styles de date et d’heure, ou à l’aide d’un modèle de date ou d’heure personnalisé, spécifiés pour cette occurrence de DateTimeFormatter.
Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus
est définie sur :
LastOperationStatus.NO_ERROR
Sinon, la propriété lastOperationStatus
est définie sur l’une des constantes définies dans la classe LastOperationStatus
.
Paramètres
dateTime:Date — Valeur Date devant être formatée. La plage valide est comprise entre le 1 jan 1601 et le 31 déc. 30827.
|
String — Chaîne formatée représentant la valeur de date ou d’heure.
|
Eléments de l’API associés
formatUTC | () | méthode |
public function formatUTC(dateTime:Date):String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Formate une chaîne d’affichage pour un objet Date interprété comme étant en heure UTC (utilisation des composants UTC de l’objet Date, tels que dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC et secondsUTC), conformément au modèle dateStyle, timeStyle ou dateTime. Le formatage est effectué à l’aide des conventions de l’ID de paramètres régionaux et des styles de date et d’heure, ou à l’aide d’un modèle de date ou d’heure personnalisé, spécifiés pour cette occurrence de DateTimeFormatter.
Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus
est définie sur :
LastOperationStatus.NO_ERROR
Sinon, la propriété lastOperationStatus
est définie sur l’une des constantes définies dans la classe LastOperationStatus
.
Paramètres
dateTime:Date — Valeur Date devant être formatée. La plage valide est comprise entre le 1 jan 1601 et le 31 déc. 30827.
|
String — Chaîne formatée représentant la valeur de date ou d’heure.
|
Eléments de l’API associés
getAvailableLocaleIDNames | () | méthode |
public static function getAvailableLocaleIDNames():Vector.<String>
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Répertorie tous les noms des ID de paramètres régionaux pris en charge par cette classe.
Si cette classe n’est pas prise en charge sur le système d’exploitation actuel, cette méthode renvoie une valeur nulle.
Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus
est définie sur :
LastOperationStatus.NO_ERROR
Sinon, la propriété lastOperationStatus
est définie sur l’une des constantes définies dans la classe LastOperationStatus
.
Vector.<String> — Vecteur de chaînes contenant tous les noms des identificateurs de paramètres régionaux pris en charge par cette classe.
|
Eléments de l’API associés
getDateStyle | () | méthode |
public function getDateStyle():String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Obtient le style de date de cette occurrence de DateTimeFormatter. Le style de date permet d’extraire un modèle de formatage de date prédéfini du système d’exploitation. La valeur de style de date peut être définie par le constructeurDateTimeFormatter()
, la méthode setDateTimeStyles()
ou la méthode setDateTimePattern()
.
Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus
est définie sur :
LastOperationStatus.NO_ERROR
Sinon, la propriété lastOperationStatus
est définie sur l’une des constantes définies dans la classe LastOperationStatus
.
String — Chaîne de style de date de cet outil de formatage.
Valeurs possibles :
|
Eléments de l’API associés
getDateTimePattern | () | méthode |
public function getDateTimePattern():String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Renvoie la chaîne modèle utilisée par cet objet DateTimeFormatter pour formater la date et l’heure.
Ce modèle peut être défini de l’une des trois façons suivantes :
- Via les paramètres
dateStyle
ettimeStyle
utilisés dans le constructeur - Via la méthode
setDateTimeStyles()
- Via la méthode
setDateTimePattern()
.
Pour obtenir une description de la syntaxe du modèle, voir la méthode setDateTimePattern()
.
Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus
est définie sur :
LastOperationStatus.NO_ERROR
Sinon, la propriété lastOperationStatus
est définie sur l’une des constantes définies dans la classe LastOperationStatus
.
String — Chaîne contenant le modèle utilisé par cet objet DateTimeFormatter pour formater les dates et les heures.
|
Eléments de l’API associés
getFirstWeekday | () | méthode |
public function getFirstWeekday():int
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Renvoie un nombre entier correspondant au premier jour de la semaine pour les paramètres régionaux et le système calendaire spécifiés. La valeur 0 correspond à dimanche, 1 correspond à lundi et ainsi de suite, jusqu’à la valeur 6 qui correspond au samedi.
Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus
est définie sur :
LastOperationStatus.NO_ERROR
Sinon, la propriété lastOperationStatus
est définie sur l’une des constantes définies dans la classe LastOperationStatus
.
int — Entier correspondant au premier jour de la semaine pour les paramètres régionaux et le système calendaire spécifiés.
|
Eléments de l’API associés
getMonthNames | () | méthode |
public function getMonthNames(nameStyle:String = "full", context:String = "standalone"):Vector.<String>
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Extrait une liste de chaînes localisées contenant le nom des mois du système calendaire actuel. Le premier élément de la liste correspond au nom du premier mois de l’année.
Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus
est définie sur :
LastOperationStatus.NO_ERROR
Sinon, la propriété lastOperationStatus
est définie sur l’une des constantes définies dans la classe LastOperationStatus
.
Paramètres
nameStyle:String (default = "full ") — Indique la chaîne de style de nom à utiliser. Les valeurs possibles sont :
| |
context:String (default = "standalone ") — Code indiquant le contexte d’utilisation de la la chaîne formatée. Ce contexte diffère uniquement pour certains paramètres régionaux. Les valeurs possibles sont :
|
Vector.<String> — Vecteur de chaînes localisées contenant le nom des mois pour les paramètres régionaux, le nom du style et le contexte spécifiés. Le premier élément du vecteur, à l’index 0, correspond au nom du premier mois de l’année ; l’élément suivant correspond au nom du deuxième mois de l’année, et ainsi de suite.
|
Valeur émise
TypeError — si le paramètre nameStyle ou context est défini sur null.
|
Eléments de l’API associés
getTimeStyle | () | méthode |
public function getTimeStyle():String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Obtient le style d’heure de cette occurrence de DateTimeFormatter. Le style permet d’extraire un modèle de formatage d’heure prédéfini du système d’exploitation. La valeur de style d’heure peut être définie par le constructeurDateTimeFormatter()
, la méthode setDateTimeStyles()
ou la méthode setDateTimePattern()
.
Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus
est définie sur :
LastOperationStatus.NO_ERROR
Sinon, la propriété lastOperationStatus
est définie sur l’une des constantes définies dans la classe LastOperationStatus
.
String — Chaîne de style d’heure de cet outil de formatage.
Valeurs possibles :
|
Eléments de l’API associés
getWeekdayNames | () | méthode |
public function getWeekdayNames(nameStyle:String = "full", context:String = "standalone"):Vector.<String>
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Extrait une liste de chaînes localisées contenant le nom des jours de la semaine du système calendaire actuel. Le premier élément dans la liste représente le nom pour dimanche.
Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus
est définie sur :
LastOperationStatus.NO_ERROR
Sinon, la propriété lastOperationStatus
est définie sur l’une des constantes définies dans la classe LastOperationStatus
.
Paramètres
nameStyle:String (default = "full ") — Indique la chaîne de style de nom à utiliser. Les valeurs possibles sont :
| |
context:String (default = "standalone ") — Code indiquant le contexte d’utilisation de la la chaîne formatée. Ce contexte s’applique uniquement à certains paramètres régionaux dans lesquels le nom du mois change selon le contexte. Par exemple, en grec les noms de mois diffèrent selon qu’ils sont affichés seuls ou accompagnés d’un jour. Les valeurs possibles sont :
|
Vector.<String> — Vecteur de chaînes localisées contenant le nom des mois pour les paramètres régionaux, le nom du style et le contexte spécifiés. Le premier élément du vecteur, à l’index 0, correspond au nom pour dimanche ; l’élément suivant correspond au nom pour lundi, et ainsi de suite.
|
Valeur émise
TypeError — si le paramètre nameStyle ou context est défini sur null.
|
Eléments de l’API associés
setDateTimePattern | () | méthode |
public function setDateTimePattern(pattern:String):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Définit la chaîne modèle utilisée par cet objet DateTimeFormatter pour formater la date et l’heure.
Le modèle utilisé pour formater les dates peut être définis de l’une des trois façons suivantes :
- Via les paramètres
dateStyle
ettimeStyle
utilisés dans le constructeur - Via la méthode
setDateTimeStyles()
- Via la méthode
setDateTimePattern()
.
Cette méthode a également pour effet de remplacer les styles de date et d’heure actuellement définis pour cet objet DateTimeFormatter par la valeur DateTimeStyle.CUSTOM
.
Une chaîne de modèle définit la façon dont la date et l’heure sont formatées. Le modèle contient des séquences de lettres qui sont remplacées par les valeurs de date et d’heure dans la chaîne formatée. Par exemple, dans le modèle « yyyy/MM », les caractères « yyyy » sont remplacés par une année à quatre chiffres suivie du caractère « / », et les caractères « MM » sont remplacés par un mois à deux chiffres.
Il est possible de répéter plusieurs fois la plupart des lettres utilisées dans les modèles en vue d’obtenir différents résultats, comme décrit dans le tableau ci-dessous.
Si une séquence dépasse le nombre maximum de lettres pris en charge par un modèle, elle est à nouveau associée à la séquence la plus longue correspondant à la lettre de ce modèle. Par exemple :
- MMMMMM est remplacée par MMMM
- dddd est remplacée par dd
- EEEEEEE est remplacée par EEEE
- aa est remplacée par a
- hhh est remplacée par hh
- mmmm est remplacée par mm
En théorie, un modèle peut contenir jusqu’à 255 caractères. Toutefois, certaines plates-formes imposent une limite stricte. Si le modèle dépasse la limite de caractères, la propriété lastOperationStatus
est définie sur la valeur LastOperationStatus.PATTERN_SYNTAX_ERROR
.
Tous les systèmes d’exploitation ne prennent pas en charge tous les modèles. Si un modèle n’est pas pris en charge sur la plate-forme, un modèle de substitution est alors utilisé et la propriété lastOperationStatus
est définie de façon à indiquer le recours à un modèle de substitution. S’il s’avère impossible de fournir un modèle de substitution valable, une chaîne vide est utilisée et la propriété lastOperationStatus
est définie de façon à indiquer que le modèle n’est pas pris en charge.
Le tableau suivant décrit les lettres de modèle valides, ainsi que leur signification.
Lettre de modèle | Description |
G | Ere. Remplacez la chaîne Ere par la date et le calendrier actuels. Ce modèle n’est pas pris en charge sur tous les systèmes d’exploitation. Sur les systèmes d’exploitation qui ne prennent pas en charge l’ère, les lettres du modèle d’entrée sont remplacées par une chaîne vide.
Le modèle d’ère peut comporter de une à cinq lettres, interprétées de la façon suivante :
Exemples de calendrier grégorien (pour les systèmes d’exploitation qui prennent en charge ce modèle) :
|
y | Année. Si le modèle contient deux lettres, les deux derniers chiffres de l’année s’affichent ; autrement, le nombre de lettres détermine le nombre de chiffres. Si la valeur de l’année nécessite plus de chiffres que ceux fournis par le nombre de lettres, la valeur d’année complète est fournie. S’il y a plus de lettres que celles requises par la valeur, les valeurs de l’année sont complétées par des zéros. La liste suivante indique les résultats pour les années 1 et 2005.
Exemples :
|
M | Mois de l’année. Le modèle de mois peut comporter de une à cinq lettres, interprétées de la façon suivante :
Exemples :
|
d | Jour du mois. Les modèles du jour du mois peuvent comporter une ou deux lettres, interprétées comme suit :
Exemples :
|
E | Jour de la semaine. Les modèles du jour de la semaine peuvent comporter de une à cinq lettres, interprétées de la façon suivante :
Exemples :
|
Q | Trimestre. Certaines plates-formes ne prennent pas en charge ce modèle. Les modèles de trimestre peuvent comporter de une à quatre lettres, interprétées de la façon suivante :
Exemples (pour les systèmes d’exploitation qui prennent en charge ce modèle) :
|
w | Semaine de l’année. Certaines plates-formes ne prennent pas en charge ce modèle. Ce modèle peut comporter de une à deux lettres, interprétées de la façon suivante :
Exemples pour la deuxième semaine de l’année (pour les systèmes d’exploitation qui prennent en charge ce modèle) :
|
W | Semaine du mois. Certaines plates-formes ne prennent pas en charge ce modèle. Ce modèle ne permet d’utiliser qu’une lettre.
Exemples pour la deuxième semaine du mois de juillet (pour les systèmes d’exploitation qui prennent en charge ce modèle) :
|
D | Jour de l’année. Certaines plates-formes ne prennent pas en charge ce modèle. Ce modèle peut comporter de une à trois lettres.
Exemples pour le deuxième jour de l’année (pour les systèmes d’exploitation qui prennent en charge ce modèle) :
|
F | Occurrence d’un jour de la semaine dans le mois d’un calendrier. Par exemple, cet élément affiche « 3 » s’il est utilisé pour formater la date correspondant au troisième lundi du mois d’octobre. Ce modèle ne permet d’utiliser qu’une lettre.
Exemples pour le deuxième mercredi du mois de juillet (pour les systèmes d’exploitation qui prennent en charge ce modèle) :
|
a | Indicateur am/pm. Ce modèle ne permet d’utiliser qu’une lettre, a ou p.
Exemples :
|
h | Heure du jour au format 12 heures [1 - 12]. Ce modèle doit comporter une ou deux lettres.
Exemples :
|
H | Heure du jour au format 24 heures [0 - 23]. Ce modèle doit comporter une ou deux lettres.
Exemples :
|
K | Heure du jour au format 12 heures [0 - 11]. Ce modèle doit comporter une ou deux lettres. Ce modèle n’est pas pris en charge sur tous les systèmes d’exploitation.
Exemples (pour les systèmes d’exploitation qui prennent en charge ce modèle) :
|
k | Heure du jour au format 24 heures [1 - 24]. Ce modèle doit comporter une ou deux lettres. Ce modèle n’est pas pris en charge sur tous les systèmes d’exploitation.
Exemples (pour les systèmes d’exploitation qui prennent en charge ce modèle) :
|
m | Minutes de l’heure [0 - 59]. Ce modèle doit comporter une ou deux lettres.
Exemples :
|
s | Secondes dans la minute [0 - 59]. Ce modèle doit comporter une ou deux lettres.
Exemples :
|
S | Millisecondes. Ce modèle doit comporter de une à cinq lettres. La valeur est arrondie en fonction du nombre de lettres utilisées. Lors de l’utilisation de cinq caractères (SSSSS), les fractions de millisecondes sont indiquées.
Exemples :
|
z | Time Zone. Représente le fuseau horaire en tant que chaîne qui respecte l’heure standard ou l’heure d’été, sans faire référence à un emplacement spécifique. Ce modèle n’est pas pris en charge sur tous les systèmes d’exploitation. Sur les systèmes d’exploitation qui ne prennent pas en charge les modèles de fuseau horaire, les lettres du modèle d’entrée sont remplacées par une chaîne vide. Sur les systèmes d’exploitation qui ne prennent pas en charge ce modèle, tous les paramètres régionaux ne disposent pas d’une chaîne définie. Ces paramètres régionaux sont définis sur un format GMT localisé, tel que GMT-08:00 ou GW-08:00.
Ce modèle de fuseau horaire doit comporter de une à quatre lettres, interprétées comme suit :
Exemples (pour les systèmes d’exploitation qui prennent en charge ce format) :
|
Z | Time Zone. Représente le fuseau horaire en tant que décalage à partir du temps GMT. Ce modèle n’est pas pris en charge sur tous les systèmes d’exploitation. Sur les systèmes d’exploitation qui ne prennent pas en charge les modèles de fuseau horaire, les lettres du modèle d’entrée sont remplacées par une chaîne vide.
Ce modèle de fuseau horaire doit comporter de une à quatre lettres, interprétées comme suit :
Exemples (pour les systèmes d’exploitation qui prennent en charge ce format) :
|
v | Time Zone. Chaîne reflétant le fuseau horaire générique qui ne fait pas référence à un emplacement spécifique ou qui ne fait pas la différence entre l’heure d’été et l’heure standard. Ce modèle n’est pas pris en charge sur tous les systèmes d’exploitation. Sur les systèmes d’exploitation qui ne prennent pas en charge les modèles de fuseau horaire, les lettres du modèle d’entrée sont remplacées par une chaîne vide. Sur les systèmes d’exploitation qui prennent en charge ce modèle, des chaînes de substitution sont fournies si un nom localisé n’est pas disponible.
Ce modèle de fuseau horaire doit comporter de une à quatre lettres, interprétées comme suit :
Exemples (pour les systèmes d’exploitation qui prennent en charge ce format) :
|
’Autre texte’ | Il est possible d’ajouter du texte et des signes de ponctuation dans la chaîne du modèle. Toutefois, les caractères de a à z et de A à Z sont réservés aux caractères de syntaxe et doivent être placés entre guillemets simples lorsqu’ils sont insérés dans la chaîne formatée. Pour inclure un guillemet simple dans la chaîne de résultat, deux guillemets simples doivent être utilisés dans la chaîne de modèle. Les deux guillemets simples peuvent apparaître à l’intérieur ou à l’extérieur d’une partie entre guillemets de la chaîne de modèle. Une paire de guillemets simples non concordants est ajoutée à la fin de la chaîne.
Exemples :
|
Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus
est définie sur :
LastOperationStatus.NO_ERROR
Sinon, la propriété lastOperationStatus
est définie sur l’une des constantes définies dans la classe LastOperationStatus
.
Paramètres
pattern:String |
Valeur émise
TypeError — si le paramètre pattern est défini sur null.
|
Eléments de l’API associés
setDateTimeStyles | () | méthode |
public function setDateTimeStyles(dateStyle:String, timeStyle:String):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Définit les styles de date et d’heure pour cette occurrence de DateTimeFormatter. Les styles de date et d’heure permettent de définir les modèles de formatage de date et d’heure sur les modèles prédéfinis en fonction des paramètres régionaux à partir du système d’exploitation. Cette méthode remplace les styles définis à l’aide du constructeur DateTimeFormatter()
ou à l’aide de la méthode setDateTimePattern()
. Le modèle de date et d’heure est également mis à jour en fonction des styles définis.
Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus
est définie sur :
LastOperationStatus.NO_ERROR
Sinon, la propriété lastOperationStatus
est définie sur l’une des constantes définies dans la classe LastOperationStatus
.
Paramètres
dateStyle:String — Spécifie le style à utiliser lors du formatage des dates. La valeur correspond à l’une des valeurs énumérées par la classe DateTimeStyle :
| |
timeStyle:String — Spécifie le style à utiliser lors du formatage des heures. La valeur correspond à l’une des valeurs énumérées par la classe DateTimeStyle :
|
Valeur émise
ArgumentError — si le paramètre dateStyle ou timeStyle n’est pas une constante DateTimeStyle valide.
| |
TypeError — si le paramètre dateStyle ou timeStyle est défini sur null.
|
Eléments de l’API associés
Cet exemple utilise les paramètres régionaux suivants : Anglais (Etats-Unis), Français (France), Espagnol (Espagne).
Cet exemple effectue les opérations suivantes pour chaque jeu de paramètres régionaux dans la liste :
- Crée un objet DateTimeFormatter à l’aide d’un style par défaut (style de date long, style d’heure long).
- Formate la date et l’heure actuelles à l’aide du style de date long par défaut.
- Passe à un style de date court d’affichage de l’heure uniquement à l’aide des constantes
DateTimeStyle.NONE
etDateTimeStyle.SHORT
. - Formate la date et l’heure actuelles à l’aide du style de date court d’affichage de l’heure uniquement.
package { import flash.display.Sprite; import flash.globalization.DateTimeFormatter; import flash.globalization.DateTimeStyle; public class DateTimeFormatterExample extends Sprite { private var localeList:Array = new Array("en-US", "fr-FR", "es-ES"); public function DateTimeFormatterExample() { var date:Date = new Date(); for each (var locale:String in localeList) { var dtf:DateTimeFormatter = new DateTimeFormatter(locale); trace('\n' + "LocaleID requested=" + dtf.requestedLocaleIDName + "; actual=" + dtf.actualLocaleIDName); var longDate:String = dtf.format(date); trace(longDate + " (" + dtf.getDateTimePattern() + ")"); dtf.setDateTimeStyles(DateTimeStyle.NONE, DateTimeStyle.SHORT); var shortDate:String = dtf.format(date); trace(shortDate + " (" + dtf.getDateTimePattern() + ")"); } } } }
Cet exemple effectue les opérations suivantes pour chaque jeu de paramètres régionaux dans la liste :
- Crée trois champs de texte d’entrée et de sortie.
- Crée un objet DateTimeFormatter à l’aide du jeu de paramètres régionaux Anglais (Etats-Unis).
- Appelle la fonction
configureTextField()
, qui définit la position et la taille des champs de texte, et ajoute un écouteur d’événement à l’objetpatternField
. - Lorsque l’utilisateur saisit un modèle dans le champ de texte
patternField
, la fonctiontextInputHandler
formate la date et l’heure actuelles à l’aide de ce modèle, puis affiche le résultat et la valeurlastOperationStatus
dans les champs de texte de sortie.
package { import flash.display.Sprite; import flash.events.Event; import flash.globalization.DateTimeFormatter; import flash.text.*; public class DateTimePatternExample extends Sprite { private var patternField:TextField = new TextField(); private var resultField:TextField = new TextField(); private var statusField:TextField = new TextField(); private var date:Date = new Date(); private var dtf:DateTimeFormatter = new DateTimeFormatter("en-US"); private function configureTextField():void { patternField.type = TextFieldType.INPUT; patternField.width = 300; patternField.height = 20; patternField.background = true; patternField.border = true; resultField.y = 40; resultField.width = 300; resultField.height = 20; statusField.y = 80; statusField.width = 300; statusField.height = 20; addChild(patternField); addChild(resultField); addChild(statusField); patternField.addEventListener(Event.CHANGE,textInputHandler); } private function textInputHandler(event:Event):void { dtf.setDateTimePattern(patternField.text); statusField.text = dtf.lastOperationStatus; resultField.text = dtf.format(date); } public function DateTimePatternExample() { configureTextField(); } } }
Tue Jun 12 2018, 09:30 AM Z